home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / ab20 / fish / aquarium / aquarium.lzh / docs / Readme.1st
Text File  |  1991-08-17  |  5KB  |  130 lines
  1.      _______________________________________________________________
  2.     |                                |
  3.     |                Aquarium Database            |
  4.     |            Fred Fish Disks 521 - 530            |
  5.     |_______________________________________________________________|
  6.  
  7.  
  8.  
  9. What have we got here?
  10.  
  11. This distribution will completely replace your present Aquarium Database,
  12. simultaneously bringing it up to date through disk 530.  The database is in
  13. a packed format, altered so by Ian Nicholl's AquaPack program.  This means
  14. that Aquarium will be usable through disk 600, perhaps even beyond that.
  15.  
  16. I will be releasing further updates to the database as Fish disks are
  17. released.  These will include instructions on how to join the updates to
  18. your existing database.
  19.  
  20.     NOTE: I am not the author of Aquarium; I have no source.
  21.           The author of Aquarium is B Lennart Olsson.
  22.  
  23.  
  24.  
  25. Patching Aquarium
  26.  
  27. ATTENTION: I provide this patch as a matter of extending the lifespan
  28. of Aquarium for users without harddisks until a more permanent
  29. solution can be found.  I can take no responsibility for problems of
  30. any kind that arise from applying this patch. 
  31.     I am also unsure if B Lennart Olsson would approve of altering
  32. his program.  I certainly failed to get permission.  Don't hit me!
  33.  
  34. ATTENTION: This patch will not help you unless you have two floppy
  35.            drives (or more).  Aquarium keeps the data, index, and names
  36.            files open during its operation.  If you have only one floppy
  37.            drive, you'd quickly go insane swapping disks ...
  38.  
  39. WARNING:  Make these modifications on a COPY OF THE AQUARIUM PROGRAM.
  40.           Don't say I didn't warn you!!
  41.  
  42. Ok, down to business:
  43.     Luckily, Aquarium stores a full relative path to all its data
  44. files, and we can modify these so long as we don't use up any more
  45. space than already taken (this is a safety measure).
  46.     Using NewZap, you will find that Aquarium is 97 "sectors" long.
  47. Each sector is 512 bytes.  On sector 93, you will find a sequence of
  48. bytes similar to the following rather inaccurate representation:
  49.  
  50. ASQ  CNPTNF data/index    data/data        data/names      data/keynames
  51.  
  52. It appears that the string "CNPTNF" is unique up to that point, so you
  53. can use that to locate this region within the executable.  There is
  54. another area within the executable which has names such as
  55. "data/names" etc.  That area has a lot of "r+" symbols mixed in with
  56. the file names.  Leave that region alone; it is not the one we want. 
  57.  
  58. What we need to pay attention to are the names of the four data files:
  59.     data/index
  60.     data/data
  61.     data/names
  62.     data/keynames
  63.  
  64. We will change ONLY THE "data/" portion of these, making them either
  65. "FSH1:" or "FSH2:"
  66.     FSH1:index
  67.     FSH2:data
  68.     FSH1:names
  69.     FSH1:keynames
  70.  
  71. Notice that ONLY the file "data" will be stored on FSH2: because that
  72. one is the biggest file and will reside by itself on an otherwise
  73. blank disk. 
  74.  
  75. Make sure you tell NewZap to SAVE the modifications!  Exit the program.
  76.  
  77. You will now have to prepare two new floppy disks.  Label them FSH1
  78. and FSH2 (use the relabel command or rename blank (freshly formatted)
  79. disks from the Workbench).  Make sure there is no Trashcan folder on
  80. the disk.
  81.     Store the file "data" on FSH2
  82.     Store the other files (even the Aquarium executable) on FSH1
  83.  
  84. Notice that you do NOT want to store the files in subdirectories any
  85. longer.  Store the files in the root of the respective volume.  You
  86. need no data/ directory any more since we patched Aquarium to use a
  87. logical volume name instead.
  88.  
  89. Now, when you run Aquarium (from FSH1) Intuition will ask you to insert
  90. volume FSH2 or FSH1 as required.
  91.  
  92.  
  93.  
  94. The Aquarium rewrite
  95.  
  96. Many of you have sent me email with suggestions on splitting the
  97. database into two autonomous entities, and adjusting the index, etc. 
  98. Your suggestions were much appreciated, and I am glad for the feedback
  99. from so many of you. 
  100.     Unfortunately, I tend to be a bit of a perfectionist, which is
  101. why a rewrite of Aquarium is in the planning stages and will soon be
  102. under way.  It will take some time, as I have a life to live, too, and
  103. so, I expect, does Kyle Saunders.  It seems that with Ian's help we
  104. have a little breathing room again. 
  105.     Rest assured that the Usenet community will be informed when
  106. the time is ripe. 
  107.  
  108.  
  109.  
  110. Many Thanks ...
  111.  
  112. I'd like to thank Fred Fish for his continuing efforts to provide us, the
  113. Amiga community, with an organized collection of freely distributable
  114. software.  530 Disks!!! Amazing!  Go Fred, Go!
  115.  
  116. I would also like to express my thanks to B. Lennart Olsson, who made
  117. available to us the Aquarium (Aqvarium?) for all those Fish Disks!  Beats
  118. the h*** out of searching huge text files!
  119.  
  120. Ian Nicholls of Australia, savior of time and space :-), receives my
  121. special thanks for the aqua* utilities.
  122.  
  123. And last, but not least, all those who write all that freely distributable
  124. software deserve our special thanks.  Where would we all be without YOU?
  125.  
  126.                  ___
  127.  ._.  Udo Schuermann        / | \    "There is no Way to Peace.
  128.  ( )  walrus@wam.umd.edu    \/|\/     Peace is the Way!"  -- Ghandi.
  129.                  ~~~
  130.